home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / gm313exe.zip / GMON.DOC < prev    next >
Text File  |  1989-09-23  |  44KB  |  1,053 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                 **********************************************              
  29.                 ******     Game Monitor (GMon) 3.13     ******
  30.                 ******         By John Morris           ******
  31.                 ******        The Reno RBBS-PC          ****** 
  32.                 ******  (702) 746-1358  Voice           ******
  33.                 ******  (702) 746-1364  Data 1  8:919/1 ******
  34.                 ******  (702) 746-1365  Data 2  8:919/2 ******
  35.                 **********************************************
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.   Welcome to GMon. I conceived GMon well over two years ago, and have finally
  69. gotten the program to work like I had originally planned. I wanted a flexible,
  70. yet small and fast Game Monitor for my RBBS.  I had originally planned on the
  71. program on being around 70-80k, and it ended up being 85k with all the features
  72. added in. (I was close!).   GMon is actually a SINGLE monitor program, but for
  73. compatibility sake it needs a program called MONITOR1.EXE to run Doorware. Thus
  74. my MONITOR1.EXE simply has one function; to 'RUN' GMon. GMon started out as a
  75. central program to run my games from, but it has ended up as a 'Door Control'
  76. program allowing you to run nearly any kind of program through it.
  77.  
  78. Features of GMon:
  79. ----------------- 
  80.  
  81. 1. Speed.    GMon doesn't have a lot of unnecessary I/O to the user, so they
  82.    can get to where they want to go, the games.
  83.  
  84. 2. Size.     GMon is a single program, 85k in size.  To be compatible with
  85.    Doorware, a small program called MONITOR1.EXE is supplied.  If you are
  86.    writing your own Door programs, you may simply bypass MONITOR1.EXE and
  87.    'RUN' GMON.EXE directly.  (This also speeds up Door execution.)
  88.  
  89. 3. Maintenance.  GMon does its own daily maintenance which will delete
  90.    inactive users from your user file.  The keeps your NAMES.DOR file
  91.    from becoming a creeping terror, taking up more, and more disk space.
  92.    You set the maximum amount of days a user may be idle.
  93.  
  94. 4. Paths.    GMon can be run a variety of ways.  For instance,  you could
  95.    put GMon in your BBS subdirectory, and put all your other games in
  96.    a separate subdirectory, and GMon will function normally.  Or, you could
  97.    put your BBS in one subdirectory, GMon in another, and the games in yet
  98.    another subdirectory.  Another method is to put each game in its own
  99.    subdirectory. this will allow you to run any version of that game as
  100.    long as the files it needs are in the same directory.Or simply put the 
  101.    BBS, GMon, and the games in the  same directory.
  102.  
  103. 5. Color.    GMon uses Ansi Color for all prompts. You can tell GMon
  104.    to display color ALL the time.
  105.  
  106. 6. Help.     GMon has a small help file which the user can display at 
  107.    anytime.
  108.  
  109. 7. Commands.   All commands in GMon are input at the same prompt. Some
  110.    commands are similar to RBBS (so as not to confuse the user) such as
  111.    the G)oodbye or H)elp commands.
  112.  
  113. 8. Time limits.  GMon sets daily time limits, and session limits per user 
  114.    security level in the RBBS. Also you can specify the time, during the
  115.    day, when the user can use GMon.
  116.  
  117. 9. Scoring.  When viewing the scores, you get an up-to-the second report of
  118.    the current scores.
  119.  
  120. 10. Running a program.  To run a program, a user simply needs to input the
  121.     number at the same prompt where every other command is given. You DO
  122.     NOT need to hit M to run a game.  If you wish to see a short listing
  123.     of games available, simply hit [ENTER]. And to see a full description
  124.     of the games, hit M then Y)es for game descriptions. After the games
  125.     are displayed you are back at the same prompt as before. Again, a user
  126.     who frequents your games area doesn't have to sit back and have lunch
  127.     while the games are displayed everytime, he will get to those games he
  128.     wants to play.
  129.  
  130. 11. Each game now has its own security level.  You need to edit you GAMES.DOR
  131.     file to add this feature, but it is well worth the effort.
  132.  
  133. 12: PCB Doors.  GMon has the built-in ability to run PCBoard doors. This
  134.     feature will be discussed later.
  135.  
  136. 13: Log.   GMon produces its own log show which games are run and by whom.
  137.     It also shows when maintenance was run. Etc.
  138.  
  139. 14: GMEdit31.  GMon Edit 3.1 is a complete GMon editing program, which can
  140.     be used to edit GMon files both from local, AND remote. Files that
  141.     can be edited are GMON.DEF, GAMES.DOR, and NAMES.DOR.
  142.  
  143. Copyright & License Info
  144. ------------------------
  145.  
  146.   GMon is Copyrighted by myself (John Morris). This means that I am the 
  147. -owner- of GMon. This means that my rights to the program are protected 
  148. under National Law, and International Treaty!
  149.  
  150.   Most people shouldn't be concerned with all of that. But there are a
  151. few who insist on tweaking my old code aorund and putting their own
  152. name on it.  That practice is Unlawful, Unethical, and just plain theft.
  153.  
  154.   All users of GMon are granted a limited license to use, copy and
  155. distribute GMon any way they see fit as long as a few rules are
  156. obeyed:
  157.  
  158. 1.  You may use the program for any commercial, or non-commercial purpose.
  159.    Use it on your company, private or school BBS, or just about anything
  160.    else, I leave it up to your imagination.
  161.  
  162. 2.  You may copy and distribute as many copies of this program as you like,
  163.    as long as you don't charge money for the program itself.  A small fee
  164.    is allowed (for copying, handling, mailing, and the diskette carrying
  165.    the copy) is allowed, BUT this amount is not to exceed the real costs.
  166.    (in other words, you may NOT make a profit!)
  167.  
  168. 3.  The program is used, and/or distributed unmodified, wih complete
  169.    documentation.
  170.  
  171.  
  172. Warranty
  173. --------
  174.  
  175.   Warranty?? Are you nuts?  There is no warranty of ANY kind given on
  176. the operation of GMon! This program is provided AS IS!, and you use it
  177. at your own risk!
  178.  
  179.  
  180. GMon Version History
  181. --------------------
  182.  
  183. 1/10/88 - GMon 1.0
  184. -------
  185. First Release of GMon. Written to completely compatible with the Door
  186. Monitor program, with improvements in speed and size.
  187.  
  188. 1/24/88 - GMon 2.0
  189. -------
  190. Release date of version 2 of GMon. The GAMES.DOR file format was completely
  191. reworked to be more flexible. ie: Instead of having to include certain
  192. strings (ex. PCB11) in the descriptions to run PCB doors, you instead just
  193. change the program 'type'. The batch file used by GMon was changed from
  194. GMONPCB.BAT to GMONEXTx.BAT. This was changed to make sure multi-node
  195. systems used the correct batch file. The user interface was changed to
  196. look more like an RBBS command prompt, thus making the user feel at home
  197. with the program (I hope!) You can now customize the menu of commands the
  198. user sees, MENU.MON.  An X-pert toggle was added to switch the menu on/off.
  199.  
  200. 2/28/88 - GMon 2.1
  201. -------
  202. GMon 2.1 release date.  Several bugs cleared up, and some more info
  203. on batch files was added to the documentation. It should now run as easy
  204. on a single node system as a multi-node system.
  205.  
  206. 3/13/88 - GMon 2.2
  207. -------
  208. GMon 2.2 release date.  Fixes were applied to the PCBoard interface which
  209. includes a total rewrite of the PCBOARD.DAT files GMon outputs. This seems
  210. to clear up the 'error 62 at line 10040' problem with PCB12 doors. Also
  211. PCB mode 4 was included which will write out plain PCBOARD.SYS and 
  212. PCBOARD.DAT files. Hopefully this will make GMon compatible with other
  213. PCB12 games.. let me know if you find any.  SysOps, If you hit the 'F1'
  214. key the program will IMMEDIATELY exit to DOS. I put it in there 'just in
  215. case'.
  216.  
  217. 04/10/88 - GMon 2.3
  218. --------
  219. Gmon 2.3 release date. The PCBoard interface was rewritten (again!) so that
  220. GMon would output a dummy pcboard user file along with the other PCB files
  221. so that all Dorpatch routines greater than 2.6 would run. These fixes work
  222. automatically, so you need to do nothing except add the games to the file 
  223. GAMES.DOR and they should run. A bug in the program which didn't write the 
  224. exact amount of time used, by the user, was cleared up.
  225. Also added was an improved GMon edit program call GMEDIT20. It includes a
  226. NAMES.DOR editor in addition to the older GMONEDIT functions.
  227.  
  228. 02/15/88 - GMon 3.10  (3.0x released only as a beta test)
  229. --------
  230. GMon 3.0 release date. Several new features added this time. Main feature?
  231. Hmm.. howsabout 15k smaller EXE file.. thats the main feature! Added to
  232. the game are several switches. You can tell GMon to use a different
  233. GAMES.DOR file for each node. This filename would then be GAMESx.DOR 
  234. (where x is the node number). You can shorten the GMon prompt to simply:
  235. GMON Command? (without the '<A,B,C,...>' etc). You can have GMon list 
  236. games by category. Aliases are now supported by GMon. If you have these
  237. features turned OFF, GMon will look, and behave just exactly like it
  238. did in the past. GMon also now has a batch mode so it can be used as a
  239. simple RBBS - 2 - PCB11/PCB12/PCB14/GAP/WILDCAT! converter. (see below)
  240.  
  241. GMEdit30 has been rewritten to be used locally, or from remote!  Added
  242. to GMEdit30 is a GAMES.DOR editor. GMEdit30 can be accessed by using
  243. the SysOp command of 'E' (for Editor). Be sure GMEDIT30.EXE is in the
  244. same directory as GMON!. When editing the GAMES.DOR file with GMEdit30
  245. you'll notice that GMEdit30 will change the 'look' of the file ever
  246. so slightly. This change in looks doesn't change the way the file works,
  247. so don't worry about it.
  248.  
  249. 02/25/89 - GMon 3.11
  250. --------
  251. A maintenance update to fix a problem in the /C3 and /C4 modes. You'll
  252. no longer get an 'Illegal Function Call' when using these two modes.
  253.  
  254. 09/24/89 - GMon 3.13
  255. --------
  256.  Another maintenance update, along with a couple added interfaces. GMon
  257. should now enforce time limts correctly in all cases. Formerly, an entry
  258. in the TIMELIMIT.DOR file that looked like this:
  259. 9,45,90,,
  260. would give an error "You must call between 0000 and 2359"  
  261. This error is fixed.  Also a user could cheat GMon for extra time. This is
  262. also fixed.
  263.  The GAP interface is fixed. Added interfaces are and OPENDOOR.SYS (Fast
  264. Fingers door program interface) and a USERINFO.TXT interface (MG Generic
  265. format) For games like Planet Busters.
  266.  Also **NEW** batch file info.  Some -external- door programs tend to -eat-
  267. command line parameters. So if you run a multi-line system this causes
  268. ALL kinds of problems!  I gotta fix!  see the batch file section.
  269.  MONITOR1.EXE is now written in 'C' which really saves on hard disk space.
  270. Its now an 11k program instead of 28k. Every little bit helps!  Look for
  271. GMon to be converted to 'C' in the near future. (along with TW!)
  272.  OH YEAH!...  Almost forgot.  I did some work on GMEdit30.. and fixed that
  273. really nasty GAMES.DOR editor error.  Its now known as GMEdit31.
  274.  
  275. I wish to thank Mike Hammer, and Roger Reesor and everyone else who helped
  276. with their ideas and bug fixes, you have all helped in making GMon the best
  277. it can be. I'd like to be able to name you all, but there are just way
  278. to many of you. GMon wouldn't be possible without you.
  279.  
  280.  
  281. Bug Reports / Suggestions / Ideas
  282. ---------------------------------
  283.  
  284.   If you can't reach me through my BBS numbers, give me a buzz voice, or
  285. send me mail at:
  286.  
  287.            John Morris
  288.            2620 Emily St.
  289.            Reno, Nv 89503
  290.  
  291.   I try to be as receptive to ideas as possible, so let me know of your
  292. ideas or suggestions.
  293.  
  294.  
  295. Compatibility:
  296. --------------
  297.  
  298.   GMon was first designed to be as compatible as possible with the original
  299. Doorware programs distributed by Bob Westcott. As the program was developed
  300. it was necessary to change some of the file formats around to make GMon
  301. more powerful. If you are running the Doorware Monitor and are thinking of
  302. making the switch to GMon read on.
  303.  
  304.  
  305. Changes from the Doorware Monitor program
  306. -----------------------------------------
  307.  
  308.   The Doorware Monitor uses a file called GAMES.DOR to describe the programs
  309. the user can run. It simply contained the program name and a description.
  310. To allow GMon to have total flexibility the GAMES.DOR file was completely
  311. changed. Each line has several parameters.
  312.  
  313. GAMES.DOR     
  314. ---------
  315.  
  316.    Here is what a single line from your GAMES.DOR file looks like:
  317.  
  318. TW2,C:\DOORS\,5,0,Tradewars.. the latest! the greatest! TW2 release 6!
  319.  
  320. or,
  321.  
  322. GameName,GameDirectory,GameSecurity,GameType,GameDescription
  323.  
  324. GMon will parse the line out and reassemble it in memory to look like the 
  325. Doorware line, without all the extra info. The Game Name, Directory in,
  326. Security level, and Description are self explanitory. The Game Type is very
  327. easy to understand. GMon knows six (6) game types as follows:
  328.  
  329.  
  330. Game Types:
  331. -----------
  332.  
  333. 0 - Regular RBBS door, GMon will use the internal basic RUN command
  334. 1 - External Door, Any door to be used without the Run command
  335. 2 - PCBoard 11.x door program
  336. 3 - PCBoard 12.x door program  (PCBOARDx.SYS & DAT is written)
  337. 4 - PCBoard 12.x door program  (plain PCBOARD.SYS & .DAT w/o node #)
  338. 5 - Wildcat door program       (using CALLINFO.BBS file)
  339. 6 - GAP program                (using DOOR.SYS file)
  340. 7 - PCBoard 14.x door program  (PCBOARDx.SYS is written)
  341. 8 - PCBoard 14.x door program  (plain PCBOARD.SYS & .DAT are written)
  342. 9 - Fast Fingers door program  (OPENDOOR.SYS file)
  343. 10- MG Generic Format          (USERINFO.TXT)
  344.  
  345. (More MODES coming soon!)
  346.  
  347. Listing Games By Category!
  348. --------------------------
  349.  
  350. With the start of GMon 3.0 a SysOp my allow a user to list games by
  351. category. First, You must turn on the 'list programs by category switch'
  352. in GMEDIT30. Then you must make a GAMES.CAT file. It should be formatted
  353. like so:
  354.  
  355. Adventures
  356. Multi-Player Games
  357. Casino games
  358. Etc.
  359.  
  360. Each line is a category, so Adventures would be category 1, Casino games
  361. would be category 3, etc. 
  362. You should also take note of the special format of the GAMES.DOR file when
  363. specifying category mode. It looks like this:
  364.  
  365. TW2,C:\DOORS\,5,0,2,Tradewars.. the latest! the greatest! TW2 release 6!
  366.  
  367. or,
  368.  
  369. GameName,GameDirectory,GameSecurity,GameType,GameCategory,GameDescription
  370.                                                  ^ *NEW*  
  371.  
  372. NOTE! there is an added field here!  When using category mode, you must
  373. add a new field which is the games category. In the TW2 example above,
  374. the category is 2, and combined with the above GAMES.CAT file, TW2 will
  375. be listed under 'Multi-player games'.
  376.  
  377. When a user lists the files, he/she will be asked for a category or
  378. 'A' for all, when they pick A)ll the games will be listed like normal.
  379. Otherwise, GMon will search for games with the specified category
  380. number.
  381.  
  382. GAMES.DOR filenames:
  383. --------------------
  384.  
  385.   Beginning with GMon 3.0 you will have 3 options of telling GMon
  386. the FILENAME of the GAMES.DOR file. For Most SysOps all options will
  387. be 'off' and GMon will look for the filename GAMES.DOR. 
  388.   Some SysOps have special situations that require options. If you wish,
  389. you can tell GMon to use separate GAMES.DOR files for each node. The 
  390. filename format will be: GAMESx.DOR   where 'x' is the node number.
  391. (make sure if you use this option to have a separate file for each node!)
  392.   A third option allows you to override the regular GMon conventions
  393. and specify the GAMES.DOR file on the command line. To use this option
  394. use the command line switch: /O filename.ext
  395.   Example:   GMON 1 /O GMONBETA.DOR
  396.   Gmon will load and look for game descriptions in the GMONBETA.DOR file.
  397.  
  398. NOTE: The internal format of the file doesn't change, just the filename.
  399.  
  400. Game Types (again):
  401. -------------------
  402.  
  403. Doorware programs will be run with the Type '0', the others are for special
  404. programs. The PCBoard modes are the same as the external mode, but GMon
  405. will also write the correct PCBoard files in the sub-directory you indicate.
  406.  
  407. Game Security:
  408. --------------
  409.  
  410. If a users security level is below the game security level, then the game will
  411. be TOTALLY invisible to the user. A good way to use security levels to your
  412. advantage is like this;  You could actually add TWEDIT to you GAMES.DOR file
  413. but assign it a security level high enough so only you or a remote sysop could
  414. enter it, and edit your Tradewars data file.
  415.  
  416. Game Subdirectories:
  417. --------------------
  418.  
  419. NOTE!:
  420. Because you now specify a sub-directory for EVERY game, you must make sure
  421. the RBBSxPC.DEF is located in every sub-directory in which you have placed 
  422. an RBBS door (Of course, this is ONLY if the game requires it!, and nowadays 
  423. not too many games use the .DEF file).
  424.  
  425. GAMES.DOR formats:
  426. ------------------
  427.  
  428. You CANNOT have any commas OR double quotes in the game description OR GMon 
  429. will NOT load properly!  This can cause many mysterious errors!
  430.  
  431. The format of the GAMES.DOR file must be exactly as stated, so look through
  432. the games.dor file provided to compare it with yours in case you have a 
  433. problem. If your format isn't correct you WILL have problems, so beware!
  434.  
  435. TIMLIMIT.DOR
  436. ------------
  437.  
  438. The new TIMLIMIT.DOR file will assign session and daily limits per security 
  439. level. You can also specify what time of day a user can use GMon.
  440. A sample of my TIMLIMIT.DOR file:
  441.  
  442. format:   Security level,Session limit,Daily limit,Start Time,End Time
  443.  
  444. 5,25,45,0600,1600
  445. 6,30,60,0400,2000
  446. 7,45,75,,
  447. 20,90,180,,
  448.  
  449. It is easy to see how it works. Line one would allow a user at level 5 a
  450. session limit of 25 minutes, and a daily limit of 45 minutes, and they
  451. could use GMon between 6am and 4pm. Line 4 would allow a level 20 user a
  452. session limit of 90 minutes, and a daily limit of 180 minutes, and there
  453. is no restriction as to when they can use the monitor.
  454.  
  455. SCORBRD1.DOR
  456. ------------
  457.  
  458. This file is the same as the Doorware Monitor MONITOR1.SCR file.
  459. MONITOR.SCR can be erased (if you are using the doorware monitor)
  460.  
  461.  
  462. GMON.DEF and GMEDIT30.EXE
  463. -------------------------
  464.  
  465. GMon stores all its necessary info in a file called GMON.DEF  To create
  466. GMON.DEF just run the included program GMEDIT30 and if no GMON.DEF is 
  467. found a new one will be created. First you will be displayed what the
  468. current GMon defaults are, and you can edit them to your tastes. Because
  469. I wish to keep GMon as flexible as possible, it was suggested that I
  470. do NOT rely upon the RBBSxPC.DEF file for my info. This will let you
  471. continue running GMon after you switch to another version of RBBS which
  472. has a different RBBSxPC.DEF file.  GMon keeps all its needed info in the
  473. GMON.DEF file.
  474.  
  475. Record 1 Field 1  this is the name of your messages file (usually MESSAGES)
  476.                   withOUT the drive or path
  477. Record 1 field 3  SubDir where the BBS files are located, most notably,
  478.                   the MESSAGES file, and the DORINFOx.DEF file.
  479.  
  480. The rest of the fields in record one are self explanitory.
  481.  
  482. The other records are the 'NODE' records.
  483.  
  484. VERY IMPORTANT! : Be sure to edit your node records, and input the correct
  485.                   RCTTY.BAT filename in field one. Failure to do so will
  486.                   cause some wierd errors.
  487.  
  488. NOTE: Because GMon constantly changes the node record information I think it
  489.       would be best to edit just the RCTTY.BAT field info.  But I do provide
  490.       a means to edit all other node record fields.
  491.  
  492. Old Doorware under GMon:
  493. ------------------------
  494.  
  495. Because of the way older Doorware worked, the RCTTY.BAT filename was needed 
  496. so they can be run in a separate directory, GMon will copy the bat file
  497. over to the directory where the game is.  If you happen to keep getting the:
  498. 'TO RUN IN LOCAL MODE READ SYSOP.DOC'  message, then you are probably missing
  499. the bat file.  My door games determine local/remote modes by checking if
  500. there is a carrier or not, so this problem is avoided.
  501.  
  502.  
  503. Signing on in LOCAL mode
  504. ------------------------
  505.  
  506. Because of the size and speed constraints I placed on GMON, you may either
  507. sign on to GMON locally through an RBBS node that is configured specifically 
  508. for COM0 in the CONFIG program that comes with RBBS, or you must enter your
  509. BBS locally using the ESC key, log off your BBS, hit the F1 key to leave
  510. RBBS, and then run GMon (or the GMon .BAT file). 
  511.  If you use the COM0 method you logon to RBBS using your sysop passwords as 
  512. specified in CONFIG, then go to the doors section and select the games.  
  513. RBBS will exit to the GMON batch file and run GMON in local mode so you can 
  514. test the games and see how your logic works in the batch files you write.
  515.   This is especially useful in writing PCBoard batch files, as described 
  516. below.  You still need to run Doorware-type games in the manner explained 
  517. in the Doorware docs, and then you can reinistate GMON by running the GMON 
  518. batch file (GAMES.BAT in these illustrations).
  519.  
  520. (**NOTE!**: GMEDIT30 will run from DOS with this command only> GMEDIT30 /L)
  521.  
  522. Files GMON creates for it's own use
  523. -----------------------------------
  524.  
  525. These files are created and maintained entirely by the GMON program for it's 
  526. own use, so if you see them listed when you do a directory of your RBBS and 
  527. games areas do not be alarmed or worry about these files' purpose.
  528.  
  529.   FILENAME          PURPOSE IN GMON
  530.   ~~~~~~~~          ~~~~~~~~~~~~~~~
  531.   NAMES.DOR         Keeps track of all users who sign on through GMON.
  532.  
  533.   TIMEOFFx.DOR      Holds seven fields of info that RBBS doorware and
  534.                     the MONITOR1.EXE program needs. 'x' - stands for
  535.                     the node number, and is '0' on a single node system.
  536.  
  537.   MONILOG.DOR       Callers file for GMON.  Keeps track of user activities
  538.                     through GMON.
  539.  
  540.   PCBOARDx.SYS      These three files hold info needed by PCBoard doors to 
  541.   PCBOARDx.DAT      operate properly.
  542.   GMUSERS.DAT
  543.  
  544.   ERRORS.DOR        Holds a record of all errors encountered by the GMON 
  545.                     program in it's operation -- a "must read" if you
  546.                     are having problems.  Most common error encountered
  547.                     by GMon testers - a file needed was not in the proper
  548.                     subdirectory.  Check which files you have where, and
  549.                     if necessary copy all data files to all places to make 
  550.                     the problem go away.
  551.    GMON.TMP         This file MUST contain the directory in which GMon 
  552.                     resides.  If not, all sorts of wierd things happen!
  553.  
  554. Because of GMon's ability to handle so many subdirectories it is easy to 
  555. become hopelessly lost in the process unless you follow proper programming
  556. procedures and have a chart of what you are trying to accomplish.  A 
  557. subdirectory tree is most helpful, as is a logic chart showing you exactly 
  558. what you are trying to get your door system to do.
  559.  
  560. Running RBBS Doorware-type and most other games
  561. -----------------------------------------------
  562.  
  563. These files are handled very easily through GMON because of the MONITOR1.EXE
  564. program included in the GMON package.  Your batch file to run the game needs 
  565. to be named exactly as the name of the program appears in the GAMES.DOR file,
  566. so if you have a line that is:
  567.  
  568. TW2,C:\DOORS\,5,0,Tradewars.. the latest! the greatest! TW2 release 6!
  569.  
  570. in GAMES.DOR, your filename to execute the TW2 program needs to be TW2.EXE
  571. or TW2.COM and GMON will parse the command through the system to read
  572.  
  573. TW2 %1                  
  574.  
  575. , where the %1 means as usual the node ID number.  If you are running no nodes 
  576. then the command given out through GMON is, simply,
  577.  
  578. TW2       '. To end the sentence!
  579.  
  580. And since Doorware games return to the program MONITOR1.EXE, which runs GMON,
  581. your user will be returned to the GMON program when they are done.
  582.  
  583. So all you must do to get a regular RBBS door to operate is to list the name 
  584. of the file that starts the progran in the GAMES.DOR file as noted in the 
  585. GAMES.DOR file description, put all the files for that program in the 
  586. subdirectory you indicated in GMON.DEF, and you are all set!
  587.  
  588. Quirks with Doorware Games:
  589. ---------------------------
  590.  
  591.   The Doorware game distributed by Bob Westcott seem to have one annoying
  592. quirk. The games are compatible with RBBS-PC and QBBS, but in the process
  593. of adding compatability to QBBS the games are left with a flaw. For a QBBS
  594. sysop to run a program in LOCAL mode, they must run the program without a
  595. command line, or:
  596.  
  597. KING
  598.  
  599. To tell the game a remote user is on a command line parameter must be
  600. specified, or:
  601.  
  602. KING 1
  603.  
  604.   If you are running a multi-line RBBS you won't into this problem because
  605. there is always a command line (specifying your node number). Single node
  606. systems don't need a command line parameter, so when that user eventually
  607. gets to the Doorware, the game thinks its LOCAL, no matter what!  To fix
  608. this problem, you can set up your system as if it was 'Node 1' of a multi
  609. node system. Rename your .DEF file to RBBS1PC.DEF, run RBBS-PC like this:
  610. RBBS-PC 1
  611. and GMon like this:
  612. GMON 1
  613.  
  614. and the doorware games should run fine from remote.. But here is where the
  615. catch 22 comes in.. they won't run LOCALly this way!
  616.  
  617. Take a deep breath and relax!
  618.  
  619. Again, this is very easy to set up and if something is not working right
  620. then sit back, calm down, and think about what you have done.  The MONITOR1
  621. program needs to be in all the places where you have games located, and for 
  622. this reason it is usually easiest to have all the RBBS Doorware-type games in 
  623. one subdirectory.
  624.  
  625. BATCH FILES!!   (read me!) 09/20/89
  626. -----------------------------------
  627.  
  628. Most of us are not wizards with batch files, though when it comes right
  629. down to it, they are very easy to understand.  Below I will construct a
  630. batch file flow chart which explains what happens:
  631.  
  632. *****NOTE********************************************09/20/89**********
  633. Because some door programs -EAT- the command line parameters,
  634. we will set up the MULTI-NODE batch files differently than before!
  635. First, put this command in your AUTOEXEC.BAT file:
  636.  
  637. SET NODE=x
  638.  
  639. Where 'x' is the node number. Thats it for now.  Whenever DOS sees a
  640. %NODE% in a batch file, it will substitute the node number (x) instead.
  641. ***********************************************************************
  642.  
  643. RBBS.BAT is invoked    -------------
  644. after AUTOEXEC.BAT     |  RBBS.BAT |   (run RBBS)  <----<
  645. and runs RBBS-PC.      -------------                    |
  646.                              |                          |    
  647.                              |                          |
  648. RBBS-PC creates this   ------------- (contains the name | 
  649. file to run doors, if  | RCTTY.BAT |  of the Door batch |  
  650. RBBS.BAT finds it, it  -------------  file to invoke)   |
  651. runs it                      |                          |
  652.                              |                          | 
  653.                        -------------                    |  
  654.        >------------>  | GAMES.BAT |   (run GMon)       |
  655.        |               -------------                    |                
  656.        |                     |                          |
  657.        |                     |                          | 
  658.        | (see note    ----------------                  |   
  659.        |  on this     | GMONEXTx.BAT | >----------------^
  660.        |  batch file) ----------------  (no, it doesn't exist, run RBBS.BAT)
  661.        |                     |
  662.        |                     | (yes, it exists, run external door batch file) 
  663.        |                     |
  664.        |                -------------
  665.        |                | CHESS.BAT |   (run CHESS DOOR)
  666.        |                -------------
  667.        |                     |
  668.        |                     |
  669.        ^---------------------<
  670.    (TOP GUN ends, return to GMon)
  671.  
  672.  
  673.    GMONEXTx.BAT  (GMON.EXE creates this batch file to run
  674.                  external doors, If GAMES.BAT finds it, it runs
  675.                  it. Inside this batch is the name of the batch
  676.                  file used to run the external door program. If
  677.                  GMONEXTx.BAT does NOT exist, then GAMES.BAT must 
  678.                  change directory to the RBBS directory and end, 
  679.                  this will automatically re-invoke RBBS.BAT)
  680.                      
  681.    CHESS.BAT     (this batch file is run by GMONEXTx.BAT, when
  682.                  the user is done with chess, the CHESS.BAT
  683.                  file MUST change directory back to the RBBS
  684.                  directory and reinvoke the GAMES.BAT file!) 
  685.                  >  Make sure this external batch file is <
  686.                  >     in the same directory as GMon!!    <   
  687.  
  688. Example Batch files below:
  689. --------------------------
  690.  
  691. RBBS.BAT        single node system:
  692. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  693.  
  694. WATCHDG1 OFF                           'TURN OFF WATCHDOG PROGRAM FOR COM1
  695. IF EXIST RBBS1F1.DEF DEL RBBS1F1.DEF   'DELETE -F1- FILE CREATED BY RBBS
  696. IF EXIST RCTTY.BAT DEL RCTTY.BAT       'DELETE RCTTY.BAT FILE (IF PRESENT)
  697. RBBS-PC.EXE                            'RUN RBBS-PC
  698. IF EXIST RBBS1F1.DEF GOTO EXIT         'IF F1 KEY PRESSED, EXIT BATCH FILE
  699. IF EXIST RCTTY.BAT WATCHDG1 ON         'TURN ON WATCHDOG PROGRAM
  700. IF EXIST RCTTY.BAT RCTTY.BAT           'RUN RCTTY.BAT FILE
  701. CD\                                    'RETURN TO RBBS SUBDIR (JUST IN CASE)
  702. RBBS.BAT                               'RESTART RBBS.BAT FILE
  703. :EXIT                                  'BAT FILE GOES HERE IF F1 KEY PRESSED
  704.  
  705.  
  706. RBBS.BAT         multi-node system:  (used for all nodes!)
  707. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  708.  
  709. WATCHDG1 OFF                           'TURN OFF WATCHDOG PROGRAM
  710. IF EXIST RBBS%NODE%F1.DEF DEL RBBS%NODE%F1.DEF  'DELETE F1 FILE CREATE BY RBBS
  711. IF EXIST RCTTY%NODE%.BAT DEL RCTTY%NODE%.BAT  'DELETE RCTTY FILE (IF PRESENT)
  712. RBBS-PC.EXE %NODE%                     'RUN RBBS-PC.EXE FOR THIS NODE
  713. IF EXIST RBBS%NODE%F1.DEF GOTO EXIT    'IF F1 KEY PRESSED, EXIT BATCH FILE
  714. IF EXIST RCTTY%NODE%.BAT WATCHDG1 ON   'TURN ON WATCHDOG PROGRAM
  715. IF EXIST RCTTY%NODE%.BAT RCTTY%NODE%.BAT 'RUN RCTTY.BAT FILE
  716. CD\                                    'RETURN TO RBBS SUBDIR (JUST IN CASE)
  717. RBBS.BAT                               'RESTART RBBS1.BAT FILE
  718. :EXIT                                  'BAT FILE GOES HERE IF F1 KEY PRESSED
  719.  
  720. RCTTY.BAT ----->  RBBS-PC.EXE CREATES THIS FILE, DON'T WORRY ABOUT IT!
  721.  
  722. GAMES.BAT         single node system:
  723. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  724.  
  725. WATCHDG1 OFF                           'TURN OFF WATCHDOG PROGRAM
  726. IF EXIST GMONEXT1.BAT DEL GMONEXT1.BAT 'DELETE SPECIAL GMON BATCH FILE
  727. GMON.EXE                               'RUN GMON
  728. IF EXIST GMONEXT1.BAT GMONEXT1.BAT     'RUN SPECIAL GMON BATCH FILE
  729. CD\                                    'RETURN TO RBBS SUBDIR (JUST IN CASE)
  730.  
  731.  
  732. GAMES.BAT          multi-node system:  (same .bat file used by BOTH nodes!)
  733. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  734.  
  735. WATCHDOG OFF                             'TURN OFF WATCHDOG PROGRAM
  736. IF EXIST GMONEXT%NODE%.BAT DEL GMONEXT%NODE%.BAT 'DELETE GMON BATCH FILE
  737. GMON.EXE %NODE%                          'RUN GMON
  738. IF EXIST GMONEXT%NODE%.BAT GMONEXT%NODE%.BAT     'RUN GMON BATCH FILE
  739. CD\                                      'CD TO RBBS SUBDIR (JUST IN CASE)
  740.  
  741.  
  742. GMONEXTx.BAT ----> GMON.EXE CREATES THIS FILE, DON'T WORRY ABOUT IT!
  743.  
  744. PCBoard door compatability
  745. --------------------------
  746.  
  747. Because of the lack of readily available conversion program to run PCB
  748. doors from your RBBS, I included the capability in GMon.  (There are
  749. a couple conversion programs, but they either aren't cheap, or there is
  750. no source code) 
  751.  
  752. With the Latest release of GMon, there are three (3) ways to tell GMon you
  753. are running a PCBoard door program.
  754.  
  755. If you wish to use a PCB version 11.x door, you need to set the program
  756. Type to '2'. (see below example)
  757.  
  758. If you wish to run a PCB version 12.x game, you need to set the program
  759. Type to '3'. (see below example)
  760.  
  761. To increase the likelyhood of comaptibility, I have made a mode '4' which
  762. will write out plain PCBOARD.SYS, and PCBOARD.DAT files without the node
  763. number. This is for games where you cannot specify the exact SYS file to
  764. look for.. This mode will write PCB 12.x files only.
  765.  
  766. Version 3.0 adds a new PCBoard mode, 14.  If you specify mode 7, or 8, you
  767. will be able to run PCBoard 14 doors as they become available.
  768.  
  769. I suggest you use PCBoard doors that use Clint Labarthes Door Patch Routines,
  770. or Sam Smiths ProKit. I've tested ProKit (for PCB14) doors with success.
  771.  
  772. After you have set up the descriptions in the GAMES.DOR file  example:
  773.  
  774. TopGun,C:\DOORS\PCB\,5,2,Top Gun Trivia, Great Trivia Game!
  775. Bull,C:\DOORS\PCB\,5,3,Bay Street Bulls, fun stock market simulation! 
  776.  
  777. Next you need to set up the PCB door programs (the ones using the Door 
  778. patch routines) to search for the files  PCBOARDx.SYS and PCBOARDx.DAT
  779. (where x is the node) you do this in the .CFG file.
  780.  
  781. *** NOTE: GMon will write the PCBoard files to the sub-directory specified
  782.  
  783. Let me show you what I did to get Top Gun trivia working.
  784.  
  785.  
  786. My set-up:
  787. The BBS is in C:\RBBS
  788. GMon is in C:\RBBS
  789. The RBBS Doors are in C:\DOORS\
  790. The PCB Doors are in C:\DOORS\PCB\
  791. ALL nodes use COM2
  792.  
  793.  
  794. IN a single node system you would simply edit the TGTRIV.CFG. The first
  795. three lines are the main ones.  The first line is the com port that you
  796. are using. second is the drive/path to the PCBOARD.SYS file and the third
  797. is the name of your BBS.  example:
  798.  
  799. COM2
  800. PCBOARD1.SYS
  801. The Reno RBBS
  802. Television & Movies
  803. Music
  804. Etc.
  805. Etc.
  806.  
  807. For Door Patch doors, GMon will create the PCBOARDx.SYS file in the 
  808. sub-directory where the door resides.  so you need to include a drive/path 
  809. in the GAMES.DOR file so the PCB door can locate the .SYS file.
  810.  
  811. If you are running multiple nodes, you need to copy and rename your .CFG
  812. files.  ie: TGTRIV1.CFG TGTRIV2.CFG  etc.  TGTRIV1.CFG would look like
  813. the example above and TGTRIV2.CFG would look like:
  814.  
  815. COM2
  816. PCBOARD2.SYS
  817. The Reno RBBS
  818. blah blah
  819. etc.
  820.  
  821. After you have the .CFG files set-up, you next need to create some batch
  822. files. (see above batch file section)
  823.  
  824. First AND Most important, create the GAMES.BAT file shown above. If needed,
  825. change its contents to suit your systems set-up.
  826.  
  827. Next batch file. TOPGUN.BAT
  828.  
  829. Single node batch file:
  830. ~~~~~~~~~~~~~~~~~~~~~~~
  831. CD\DOORS\PCB
  832. TGTRIVIA.EXE TGTRIV.CFG
  833. CD\
  834. GAMES.BAT
  835.  
  836. Multi-node batch file:
  837. ~~~~~~~~~~~~~~~~~~~~~~
  838. CD\DOORS\PCB                            'go to PCB door area
  839. TGTRIVIA.EXE TGTRIV%NODE%.CFG           'run Top Gun..look for .CFG file
  840. CD\                                     'get back to BBS directory
  841. GAMES.BAT %NODE%                        'run gmon batch file again
  842. Here is how it runs.
  843.  
  844.                        -------------
  845.                        |  RBBS.BAT |   (run RBBS)  <----<
  846.                        -------------                    |
  847.                              |                          |    
  848.                              |                          |
  849.                        ------------- (created by RBBS to| 
  850.                        | RCTTY.BAT |  run doors batch   |  
  851.                        -------------  files)            |
  852.                              |                          |
  853.                              |                          | 
  854.                        -------------                    |  
  855.        >------------>  | GAMES.BAT |   (run GMon)       |
  856.        |               -------------                    | (no, it doesn't
  857.        |                     |                          |  exist, return
  858.        |                     |                          |  to bbs)
  859.        |              ----------------                  |   
  860.        |              | GMONEXTx.BAT | >----------------^
  861.        |              ----------------
  862.        |                     |
  863.        |                     |  (yes, it exists, run it) 
  864.        |                     |
  865.        |               --------------
  866.        |               | TOPGUN.BAT |   (run TOP GUN TRIVIA)
  867.        |               --------------
  868.        |                     |
  869.        |                     |
  870.        ^---------------------<
  871.    (TOP GUN ends, return to GMon)
  872.  
  873.  
  874. When GMon senses a PCB door it creates a batch file which will run a batch
  875. file with the same name as the game, instead of 'RUNning' the game as 
  876. happens normally. This batch will run the game, after the game is done, the
  877. batch file must run the GAMES.BAT file again to get to GMon. GMon 'remembers'
  878. that it ran an External/PCB door, and will come on-line just like it would 
  879. after running a regular door.
  880.  
  881. GMon will allow a user at E,7,1 to run a PCB 12 OR 14 door only, 11.x PCB
  882. didn't support those parameters.
  883.  
  884. NOTE:  As you may have noticed,  this part of the documentation isn't
  885. very clear.  Its really hard to explain the whole thing, and I hope
  886. I included everything. If you have problems, just let me know and I'll
  887. give the PCBoard section a rewrite.
  888.  
  889. PCBoard (c) 1985...1989 Clark Developement Company, Inc.
  890.  
  891.  
  892. Running 'Other' Programs through GMON
  893. --------------------------------------
  894.  
  895. It is possible to run ANY program through GMON that can output through a 
  896. modem by running it as if it were a door program.  This is because of 
  897. GMON's way of calling the External programs via batch files instead of 
  898. calling the external program via it's program name.  
  899.  
  900. The first example of an 'Other' program is to run the Chessdor through
  901. GMon.  The Chess program does NOT recognize the Monitor program, so
  902. you'll need to set the program type to '1' to turn on the external
  903. program mode.   Like this:
  904.  
  905. Chess,C:\DOORS\,5,1,Play Chess against other users of this BBS.
  906.                   ^ You must make sure you have a CHESS.BAT file in the GMon directory. It
  907. should look like this:
  908.  
  909. Single node batch file:
  910. ~~~~~~~~~~~~~~~~~~~~~~~
  911. CD\DOORS
  912. CHESSDOR
  913. CD\
  914. GAMES.BAT
  915.  
  916. Multi-node batch file:
  917. ~~~~~~~~~~~~~~~~~~~~~~
  918. CD\DOORS               'change sub-dirs to the Chess directory
  919. CHESSDOR %NODE%        'run Chessdor (see above for %NODE% info)
  920. CD\                    'changes sub-dirs to the GMon directory
  921. GAMES.BAT %NODE%       'run the gmon batch file
  922.  
  923. After you exit the Chess door, you will be returned to GMon, just like
  924. all other doors.
  925.  
  926. Other ways of using the external program mode:
  927. ----------------------------------------------
  928. You can write a batch file that redirects output through the comm port using
  929. the DOS redirection commands and the DOS EXIT function, and this has been 
  930. done by the testers of GMON quite successfully.  Because of the individual 
  931. nature of such programming, all we can do is suggest a format for the batch 
  932. file that needs to be written to execute the program.  One of ours from 
  933. testing is as follows.
  934.  
  935. Filename: OTHERS.BAT
  936.  
  937. Listing in GAMES.DOR -
  938.  
  939. OTHERS,C:\SECRET\,100,1,SYSOP'S MYSTERIOUS OTHER PROGRAM 
  940.  
  941.                   ^ note that 100 is SYSOP access on this tester's system
  942.                     and that pgm tpye '1'  calls batch routine in GMON
  943.  
  944. CONTENTS OF FILE OTHERS.BAT (that actually is called by GMON)
  945.  
  946. Single node batch file:  (COM1 USED IN EXAMPLE)
  947. ~~~~~~~~~~~~~~~~~~~~~~~
  948. WATCHDG1 ON
  949. CD \PGMDIR
  950. MAINTAIN >COM1 <COM1
  951. CD \RBBS
  952. WATCHDG1 OFF
  953. GAMES.BAT
  954.  
  955. Multi-node batch file:      (node 1 = COM1, node 2 = COM2)
  956. ~~~~~~~~~~~~~~~~~~~~~~
  957. WATCHDG%1 ON             'sets up carrier detect program for COM%1
  958. CD \PGMDIR               'changes directory to program's directory
  959. MAINTAIN >COM%1 <COM%1   'runs program MAINTAIN (RBBS updating) through COM%1
  960. CD \RBBS                 'returns to RBBS directory when done
  961. WATCHDG%1 OFF            'turns off carrier detect program
  962. GAMES.BAT %1             'runs the GMON .BAT file to get GMON up again
  963.  
  964. Remember that while GMon makes such programming possible, it is entirely up 
  965. to you to execute it and because of time constraints I cannot help you 
  966. at all in this area!
  967.  
  968. Misc GMon Stuff
  969. ---------------
  970.  
  971. Running GMon as a simple Converter program:
  972. GMon will run in batch mode so it can create a set of conversion files
  973. then exit back to DOS. To run GMon in this mode you need to use the
  974. '/Cx' switch (where 'x' is the door type.. door types are found above)
  975. If you ran GMon like this from a batch file: GMON 1 /C6
  976. Gmo will create a DOOR.SYS file used by GAP doors, and then exit back to
  977. DOS. Some notes: when using the /Cx switch you must have the node number
  978. first (as in the example) and the node number MUST be there even on a 
  979. single node system! On a single node the number would be 1. In this mode
  980. GMon still needs to be run from the BBS in a batch file because it needs
  981. a current DORINFOx.DEF file to convert from RBBS to whatever.
  982.  
  983. To run GMEDIT30 in local mode (from dos, or the first time you use GMEDIT30)
  984. use the command:
  985. C>GMEDIT30 /L
  986.  
  987. GMon requires the presence and correct format of the file DORINFOx.DEF
  988. to run properly. No modifications are needed to the file for GMon to
  989. run properly.
  990.  
  991. If you are running 15-1B or earlier you need to replace the 
  992. subroutine DOOREXIT in your version of RBBS with the one included in 
  993. GMON151B.MRG.  The file is written as a merge against the 15-1B
  994. version of RBBS, but you can also use it with other versions of RBBS
  995. that use those variables, like 15-1A.  We have not tested it with 
  996. any versions earlier than 15-1A, and remember that other door games 
  997. may need the file formats of earlier RBBSs, although no reason comes 
  998. to mind.  The main purpose of the merge is to make RBBS create 
  999. DORINFOx.DEF before it exits RBBS, so feel free to experiment with
  1000. the merge and adapt it to your purposes!  Keep in mind that GMon and 
  1001. the RBBS door games may call on files like MESSAGES and USERS to get 
  1002. information and therefore you may not be able to run GMon or RBBS 
  1003. door games from PC-Boards and other BBS systems without heavy 
  1004. modifications or adaptations.  If you are not running RBBS, you
  1005. are on your own as we do not know enough about other BBSs to be of 
  1006. much help.
  1007.  
  1008. Because you can have the games in a separate subdirectory, you have the
  1009. capability of running an older version of your door games AFTER you upgrade
  1010. to a new version of RBBS.  In my case, I am running NO 151C doors, all are
  1011. 151B compatible. I put them in a separate subdirectory, and copied over my 
  1012. 151B .DEF files.  This keeps GMon flexible, and your BBS flexible.  This
  1013. way you can take your time in getting the new door games for your new
  1014. version of RBBS, or you could avoid that altogether.
  1015.  
  1016. As Always, report all Ideas, Bugs, or anything else, I want to here from
  1017. ya!
  1018.  
  1019. I'm looking for all door program types known to modern man, which I would
  1020. like to add to my already large list of door programs in my download
  1021. directories. So, if you have some door programs and the money to burn to
  1022. upload them, I'd appreciate it very much.  By all door program types, I mean
  1023. RBBS doors, PCBoard doors, Opus doors....etc.etc.etc. the more the merrier.
  1024. Or, you can send them on disk (3 1/2", 720k - 1.44M or 5 1/4", 1.2M), to:
  1025.  
  1026.  
  1027. The Reno RBBS              
  1028. 2620 Emily St.
  1029. Reno, NV 89503    
  1030.  
  1031. Registration
  1032. ------------
  1033.  
  1034. GMon is now distributed under the Shareware concept. A contribution
  1035. of $35 is suggested if you use and like GMon. This contribution will
  1036. help me keep up on my programming expenses and keep newer versions of
  1037. GMon coming at a regular rate. 
  1038.  
  1039. *IF* requested, I will send a copy of GMon's source code after I receive 
  1040. the contribution.
  1041.  
  1042. Formats available for source code disks: 3 1/2" 720K  or,  5 1/4" 1.2M
  1043.  
  1044. Make Checks Payable to:    John Morris
  1045.  
  1046. John Morris
  1047. The Reno RBBS
  1048. 3/12/24/9600 HST
  1049. 702-746-1364 DATA
  1050. 702-746-1365 DATA
  1051. 702-746-1358 VOICE
  1052.  
  1053.